home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / mus / misc / play_handler_s.lzh / play-handler / play-handler.doc < prev    next >
Text File  |  1999-01-11  |  2KB  |  44 lines
  1.  
  2.                 PLAY-Handler   Docu
  3.  
  4. This Program was Shareware. Because of the incredible demand ( just about
  5. 0) und the fact that it is rather old now, I decided to put this program
  6. under the GNU Public License (GPL). You can find it in this directory as
  7. COPYING.
  8.  
  9. Installation: copy play-handler to your l: directory and PLAY and PLAY.info
  10. to devs:dosdrivers respectly append mountlist.play to your devs:mountlist.
  11. Now you can start it with mount play:. Alternativly you can use the
  12. install-sript.
  13.  
  14. Use: play: offers an interface to the audio.device. You open it, write a
  15. sample (raw or iff 8svx) into it and you hear it. (Caution: copy uses upto
  16. your MaxTransfer amount of memory. But you can use join which is more
  17. memory-friendly.) If you feed play: with too small pieces (<256 bytes) you
  18. will hear some sounds of silence because play doesn't get it's data fast
  19. enough. Samples will be played with double-buffering, so you hear the sound
  20. continuously if you put it to play without interrupt. Play: has an internal
  21. buffer for the sample beeing played which can be changed in size by the
  22. addbuffers command.
  23. The behaviour of play: is controlled by the name you open it.
  24. play: opens a mono channelleft to default sampling rate (8192) for raw
  25.     samples. (iff samples will be played at thier stored rate)
  26. play:s plays a sample in stereo. (Both channels the same)
  27. play:l plays only on left channels
  28. play:r plays only on right channels
  29. play:<number> plays the sample at <number> samples per second.
  30.  
  31. Both can be combined with the character before the number. play:s10000 will
  32. play the sample in stereo with 10000 samples per second. Caution: the
  33. sampling rate will not be checked for sense, so extreme values will produce
  34. strange results. play: can be open more often, as long as there is enough
  35. memory and sound channels.
  36.  
  37. Play: should work with all OS-Version. (tested with V3.0)
  38.  
  39. Bugs, improvements or anything else are welcome.
  40. Have fun when trying it out!
  41.  
  42. Joerg
  43.  
  44.